home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / AIncludes / Video.a < prev    next >
Text File  |  1996-05-01  |  32KB  |  650 lines
  1. ;
  2. ;    File:        Video.a
  3. ;
  4. ;    Contains:    Video Driver Interfaces.
  5. ;
  6. ;    Version:    Technology:    System 7.5
  7. ;                Release:    Universal Interfaces 3.0d3 on Copland DR1
  8. ;
  9. ;    Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10. ;
  11. ;    Bugs?:        If you find a problem with this file, send the file and version
  12. ;                information (from above) and the problem description to:
  13. ;
  14. ;                    Internet:    apple.bugs@applelink.apple.com
  15. ;                    AppleLink:    APPLE.BUGS
  16. ;
  17. ;
  18.     IF &TYPE('__VIDEO__') = 'UNDEFINED' THEN
  19. __VIDEO__ SET 1
  20.  
  21.     IF &TYPE('__QUICKDRAW__') = 'UNDEFINED' THEN
  22.     include 'Quickdraw.a'
  23.     ENDIF
  24.  
  25. mBaseOffset                        EQU        1                    ;Id of mBaseOffset.
  26. mRowBytes                        EQU        2                    ;Video sResource parameter Id's 
  27. mBounds                            EQU        3                    ;Video sResource parameter Id's 
  28. mVersion                        EQU        4                    ;Video sResource parameter Id's 
  29. mHRes                            EQU        5                    ;Video sResource parameter Id's 
  30. mVRes                            EQU        6                    ;Video sResource parameter Id's 
  31. mPixelType                        EQU        7                    ;Video sResource parameter Id's 
  32. mPixelSize                        EQU        8                    ;Video sResource parameter Id's 
  33. mCmpCount                        EQU        9                    ;Video sResource parameter Id's 
  34. mCmpSize                        EQU        10                    ;Video sResource parameter Id's 
  35. mPlaneBytes                        EQU        11                    ;Video sResource parameter Id's 
  36. mVertRefRate                    EQU        14                    ;Video sResource parameter Id's 
  37. mVidParams                        EQU        1                    ;Video parameter block id.
  38. mTable                            EQU        2                    ;Offset to the table.
  39. mPageCnt                        EQU        3                    ;Number of pages
  40. mDevType                        EQU        4                    ;Device Type
  41. oneBitMode                        EQU        128                    ;Id of OneBitMode Parameter list.
  42. twoBitMode                        EQU        129                    ;Id of TwoBitMode Parameter list.
  43. fourBitMode                        EQU        130                    ;Id of FourBitMode Parameter list.
  44. eightBitMode                    EQU        131                    ;Id of EightBitMode Parameter list.
  45.  
  46. sixteenBitMode                    EQU        132                    ;Id of SixteenBitMode Parameter list.
  47. thirtyTwoBitMode                EQU        133                    ;Id of ThirtyTwoBitMode Parameter list.
  48. firstVidMode                    EQU        128                    ;The new, better way to do the above. 
  49. secondVidMode                    EQU        129                    ; QuickDraw only supports six video 
  50. thirdVidMode                    EQU        130                    ; at this time.      
  51. fourthVidMode                    EQU        131
  52. fifthVidMode                    EQU        132
  53. sixthVidMode                    EQU        133
  54. spGammaDir                        EQU        64
  55. spVidNamesDir                    EQU        65
  56. ;  csTimingFormat values in VDTimingInfo 
  57. ;  look in the declaration rom for timing info 
  58.  
  59. kDeclROMtables                    EQU        'decl'
  60. ;
  61. ; Timing mode constants for Display Manager MultiMode support
  62. ;    Corresponding    .h equates are in Video.h
  63. ;                    .a equates are in Video.a
  64. ;                    .r equates are in DepVideoEqu.r
  65. ;    
  66. ;    The first enum is the old names (for compatibility).
  67. ;    The second enum is the new names.
  68. ;
  69.  
  70. timingApple12                    EQU        130                    ;  512x384 (60 Hz) Rubik timing.
  71. timingApple12x                    EQU        135                    ;  560x384 (60 Hz) Rubik-560 timing.
  72. timingApple13                    EQU        140                    ;  640x480 (67 Hz) HR timing.
  73. timingApple13x                    EQU        145                    ;  640x400 (67 Hz) HR-400 timing.
  74. timingAppleVGA                    EQU        150                    ;  640x480  (60 Hz) VGA timing.
  75. timingApple15                    EQU        160                    ;  640x870 (75 Hz) FPD timing.
  76. timingApple15x                    EQU        165                    ;  640x818 (75 Hz) FPD-818 timing.
  77. timingApple16                    EQU        170                    ;  832x624 (75 Hz) GoldFish timing.
  78. timingAppleSVGA                    EQU        180                    ;  800x600  (56 Hz) SVGA timing.
  79. timingApple1Ka                    EQU        190                    ; 1024x768 (60 Hz) VESA 1K-60Hz timing.
  80. timingApple1Kb                    EQU        200                    ; 1024x768 (70 Hz) VESA 1K-70Hz timing.
  81. timingApple19                    EQU        210                    ; 1024x768  (75 Hz) Apple 19" RGB.
  82. timingApple21                    EQU        220                    ; 1152x870  (75 Hz) Apple 21" RGB.
  83.  
  84. timingInvalid                    EQU        0                    ; Unknown timing... force user to confirm.
  85. timingApple_512x384_60hz        EQU        130                    ;  512x384  (60 Hz) Rubik timing.
  86. timingApple_560x384_60hz        EQU        135                    ;  560x384  (60 Hz) Rubik-560 timing.
  87. timingApple_640x480_67hz        EQU        140                    ;  640x480  (67 Hz) HR timing.
  88. timingApple_640x400_67hz        EQU        145                    ;  640x400  (67 Hz) HR-400 timing.
  89. timingVESA_640x480_60hz            EQU        150                    ;  640x480  (60 Hz) VGA timing.
  90. timingApple_640x870_75hz        EQU        160                    ;  640x870  (75 Hz) FPD timing.
  91. timingApple_640x818_75hz        EQU        165                    ;  640x818  (75 Hz) FPD-818 timing.
  92. timingApple_832x624_75hz        EQU        170                    ;  832x624  (75 Hz) GoldFish timing.
  93. timingVESA_800x600_56hz            EQU        180                    ;  800x600  (56 Hz) SVGA timing.
  94. timingVESA_800x600_60hz            EQU        182                    ;  800x600  (60 Hz) SVGA timing.
  95. timingVESA_800x600_72hz            EQU        184                    ;  800x600  (72 Hz) SVGA timing.
  96. timingVESA_800x600_75hz            EQU        186                    ;  800x600  (75 Hz) SVGA timing.
  97. timingVESA_1024x768_60hz        EQU        190                    ; 1024x768  (60 Hz) VESA 1K-60Hz timing.
  98. timingVESA_1024x768_70hz        EQU        200                    ; 1024x768  (70 Hz) VESA 1K-70Hz timing.
  99. timingVESA_1024x768_75hz        EQU        204                    ; 1024x768  (75 Hz) VESA 1K-70Hz timing (very similar to timingApple_1024x768_75hz).
  100. timingApple_1024x768_75hz        EQU        210                    ; 1024x768  (75 Hz) Apple 19" RGB.
  101. timingApple_1152x870_75hz        EQU        220                    ; 1152x870  (75 Hz) Apple 21" RGB.
  102. timingAppleNTSC_ST                EQU        230                    ;  512x384  (60 Hz, interlaced, non-convolved).
  103. timingAppleNTSC_FF                EQU        232                    ;  640x480  (60 Hz, interlaced, non-convolved).
  104. timingAppleNTSC_STconv            EQU        234                    ;  512x384  (60 Hz, interlaced, convolved).
  105. timingAppleNTSC_FFconv            EQU        236                    ;  640x480  (60 Hz, interlaced, convolved).
  106. timingApplePAL_ST                EQU        238                    ;  640x480  (50 Hz, interlaced, non-convolved).
  107. timingApplePAL_FF                EQU        240                    ;  768x576  (50 Hz, interlaced, non-convolved).
  108. timingApplePAL_STconv            EQU        242                    ;  640x480  (50 Hz, interlaced, convolved).
  109. timingApplePAL_FFconv            EQU        244                    ;  768x576  (50 Hz, interlaced, convolved).
  110. timingVESA_1280x960_75hz        EQU        250                    ; 1280x960  (75 Hz)
  111. timingVESA_1280x1024_60hz        EQU        260                    ; 1280x1024 (60 Hz)
  112. timingVESA_1280x1024_75hz        EQU        262                    ; 1280x1024 (75 Hz)
  113. timingVESA_1600x1200_60hz        EQU        280                    ; 1600x1200 (60 Hz) VESA proposed timing.
  114. timingVESA_1600x1200_65hz        EQU        282                    ; 1600x1200 (65 Hz) VESA proposed timing.
  115. timingVESA_1600x1200_70hz        EQU        284                    ; 1600x1200 (70 Hz) VESA proposed timing.
  116. timingVESA_1600x1200_75hz        EQU        286                    ; 1600x1200 (75 Hz) VESA proposed timing.
  117. timingVESA_1600x1200_80hz        EQU        288                    ; 1600x1200 (80 Hz) VESA proposed timing (pixel clock is 216 Mhz dot clock).
  118. timingSMPTE240M_60hz            EQU        400                    ; 60Hz V, 33.75KHz H, interlaced timing, 16:9 aspect, typical resolution of 1920x1035.
  119. timingFilmRate_48hz                EQU        410                    ; 48Hz V, 25.20KHz H, non-interlaced timing, typical resolution of 640x480.
  120. ;  csConnectFlags values in VDDisplayConnectInfo 
  121.  
  122. kAllModesValid                    EQU        0                    ; All modes not trimmed by primary init are good close enough to try 
  123. kAllModesSafe                    EQU        1                    ; All modes not trimmed by primary init are know to be safe 
  124. kReportsTagging                    EQU        2                    ; Can detect tagged displays (to identify smart monitors) 
  125. kHasDirectConnection            EQU        3                    ; True implies that driver can talk directly to device (e.g. serial data link via sense lines) 
  126. kIsMonoDev                        EQU        4                    ; Says whether there's an RGB (0) or Monochrome (1) connection. 
  127. kUncertainConnection            EQU        5                    ; There may not be a display (no sense lines?). 
  128. kTaggingInfoNonStandard            EQU        6                    ; Set when csConnectTaggedType/csConnectTaggedData are non-standard (i.e., not the Apple CRT sense codes). 
  129. kReportsDDCConnection            EQU        7                    ; Card can do ddc (set kHasDirectConnect && kHasDDCConnect if you actually found a ddc display). 
  130. kHasDDCConnection                EQU        8                    ; Card has ddc connect now. 
  131. ;  csDisplayType values in VDDisplayConnectInfo 
  132.  
  133. kUnknownConnect                    EQU        1                    ; Not sure how we'll use this, but seems like a good idea. 
  134. kPanelConnect                    EQU        2                    ; For use with fixed-in-place LCD panels. 
  135. kPanelTFTConnect                EQU        2                    ; Alias for kPanelConnect 
  136. kFixedModeCRTConnect            EQU        3                    ;  For use with fixed-mode (i.e., very limited range) displays. 
  137. kMultiModeCRT1Connect            EQU        4                    ; 320x200 maybe, 12" maybe, 13" (default), 16" certain, 19" maybe, 21" maybe 
  138. kMultiModeCRT2Connect            EQU        5                    ; 320x200 maybe, 12" maybe, 13" certain, 16" (default), 19" certain, 21" maybe 
  139. kMultiModeCRT3Connect            EQU        6                    ; 320x200 maybe, 12" maybe, 13" certain, 16" certain, 19" default, 21" certain 
  140. kMultiModeCRT4Connect            EQU        7                    ; Expansion to large multi mode (not yet used) 
  141. kModelessConnect                EQU        8                    ; Expansion to modeless model (not yet used) 
  142. kFullPageConnect                EQU        9                    ; 640x818 (to get 8bpp in 512K case) and 640x870 (these two only) 
  143. kVGAConnect                        EQU        10                    ; 640x480 VGA default -- question everything else 
  144. kNTSCConnect                    EQU        11                    ; NTSC ST (default), FF, STconv, FFconv 
  145. kPALConnect                        EQU        12                    ; PAL ST (default), FF, STconv, FFconv 
  146. kHRConnect                        EQU        13                    ; Straight-6 connect -- 640x480 and 640x400 (to get 8bpp in 256K case) (these two only) 
  147. kPanelFSTNConnect                EQU        14                    ; For use with fixed-in-place LCD FSTN (aka ``Supertwist'') panels 
  148. kMonoTwoPageConnect                EQU        15                    ; 1152x870 Apple color two-page display 
  149. kColorTwoPageConnect            EQU        16                    ; 1152x870 Apple B&W two-page display 
  150. kColor16Connect                    EQU        17                    ; 832x624 Apple B&W two-page display 
  151. kColor19Connect                    EQU        18                    ; 1024x768 Apple B&W two-page display 
  152. ;  csTimingFlags values in VDTimingInfoRec 
  153.  
  154. kModeValid                        EQU        0                    ; Says that this mode should NOT be trimmed. 
  155. kModeSafe                        EQU        1                    ; This mode does not need confirmation 
  156. kModeDefault                    EQU        2                    ; This is the default mode for this type of connection 
  157. kModeShowNow                    EQU        3                    ; This mode should always be shown (even though it may require a confirm) 
  158. kModeNotResize                    EQU        4                    ; This mode should not be used to resize the display (eg. mode selects a different connector on card) 
  159. kModeRequiresPan                EQU        5                    ; This mode has more pixels than are actually displayed 
  160. kModeInterlaced                    EQU        6                    ; This mode is interlaced (single pixel lines look bad). 
  161. kModeShowNever                    EQU        7                    ; This mode should not be shown in the user interface. 
  162. ;  csResolutionFlags bit flags for VDResolutionInfoRec 
  163.  
  164. kResolutionHasMultipleDepthSizes EQU    0                    ; Says that this mode has different csHorizontalPixels, csVerticalLines at different depths (usually slightly larger at lower depths) 
  165.  
  166.                                                             ;    Power Mode constants for VDPowerStateRec.powerState.    
  167. kAVPowerOff                        EQU        0
  168. kAVPowerStandby                    EQU        1
  169. kAVPowerSuspend                    EQU        2
  170. kAVPowerOn                        EQU        3
  171.  
  172.                                                             ;    Power Mode masks and bits for VDPowerStateRec.powerFlags.    
  173. kPowerStateNeedsRefresh            EQU        0
  174. kPowerStateNeedsRefreshMask        EQU        $00000001
  175.  
  176.                                                             ; Control Codes 
  177. cscReset                        EQU        0
  178. cscKillIO                        EQU        1
  179. cscSetMode                        EQU        2
  180. cscSetEntries                    EQU        3
  181. cscSetGamma                        EQU        4
  182. cscGrayPage                        EQU        5
  183. cscGrayScreen                    EQU        5
  184. cscSetGray                        EQU        6
  185. cscSetInterrupt                    EQU        7
  186. cscDirectSetEntries                EQU        8
  187. cscSetDefaultMode                EQU        9
  188. cscSwitchMode                    EQU        10
  189. cscSetSync                        EQU        11
  190. cscSavePreferredConfiguration    EQU        16
  191. cscSetHardwareCursor            EQU        22
  192. cscDrawHardwareCursor            EQU        23
  193. cscSetConvolution                EQU        24
  194. cscSetPowerState                EQU        25
  195. cscPrivateControlCall            EQU        26
  196. cscUnusedCall                    EQU        127                    ; This call used to expend the scrn resource.  Its imbedded data contains more control info 
  197.  
  198.                                                             ; Status Codes 
  199. cscGetMode                        EQU        2
  200. cscGetEntries                    EQU        3
  201. cscGetPageCnt                    EQU        4
  202. cscGetPages                        EQU        4                    ; This is what C&D 2 calls it. 
  203. cscGetPageBase                    EQU        5
  204. cscGetBaseAddr                    EQU        5                    ; This is what C&D 2 calls it. 
  205. cscGetGray                        EQU        6
  206. cscGetInterrupt                    EQU        7
  207. cscGetGamma                        EQU        8
  208. cscGetDefaultMode                EQU        9
  209. cscGetCurMode                    EQU        10
  210. cscGetSync                        EQU        11
  211. cscGetConnection                EQU        12                    ; Return information about the connection to the display 
  212. cscGetModeTiming                EQU        13                    ; Return timing info for a mode 
  213. cscGetModeBaseAddress            EQU        14                    ; Return base address information about a particular mode 
  214. cscGetScanProc                    EQU        15                    ; QuickTime scan chasing routine 
  215. cscGetPreferredConfiguration    EQU        16
  216. cscGetNextResolution            EQU        17
  217. cscGetVideoParameters            EQU        18
  218. cscGetGammaInfoList                EQU        20
  219. cscRetrieveGammaTable            EQU        21
  220. cscSupportsHardwareCursor        EQU        22
  221. cscGetHardwareCursorDrawState    EQU        23
  222. cscGetConvolution                EQU        24
  223. cscGetPowerState                EQU        25
  224. cscPrivateStatusCall            EQU        26
  225. ;  Bit definitions for the Get/Set Sync call
  226.  
  227. kDisableHorizontalSyncBit        EQU        0
  228. kDisableVerticalSyncBit            EQU        1
  229. kDisableCompositeSyncBit        EQU        2
  230. kEnableSyncOnBlue                EQU        3
  231. kEnableSyncOnGreen                EQU        4
  232. kEnableSyncOnRed                EQU        5
  233. kNoSeparateSyncControlBit        EQU        6
  234. kTriStateSyncBit                EQU        7
  235. kHorizontalSyncMask                EQU        $01
  236. kVerticalSyncMask                EQU        $02
  237. kCompositeSyncMask                EQU        $04
  238. kDPMSSyncMask                    EQU        $07
  239. kTriStateSyncMask                EQU        $80
  240. kSyncOnBlueMask                    EQU        $08
  241. kSyncOnGreenMask                EQU        $10
  242. kSyncOnRedMask                    EQU        $20
  243. kSyncOnMask                        EQU        $38
  244.  
  245.                                                             ;    Power Mode constants for translating DPMS modes to Get/SetSync calls.    
  246. kDPMSSyncOn                        EQU        0
  247. kDPMSSyncStandby                EQU        1
  248. kDPMSSyncSuspend                EQU        2
  249. kDPMSSyncOff                    EQU        7
  250. ;  Bit definitions for the Get/Set Convolution call
  251.  
  252. kConvolved                        EQU        0
  253. kLiveVideoPassThru                EQU        1
  254. kConvolvedMask                    EQU        $01
  255. kLiveVideoPassThruMask            EQU        $02
  256. VPBlock                    RECORD 0
  257. vpBaseOffset             ds.l    1                ; offset: $0 (0)        ; Offset to page zero of video RAM (From minorBaseOS).
  258. vpRowBytes                 ds.w    1                ; offset: $4 (4)        ; Width of each row of video memory.
  259. vpBounds                 ds        Rect            ; offset: $6 (6)        ; BoundsRect for the video display (gives dimensions).
  260. vpVersion                 ds.w    1                ; offset: $E (14)        ; PixelMap version number.
  261. vpPackType                 ds.w    1                ; offset: $10 (16)
  262. vpPackSize                 ds.l    1                ; offset: $12 (18)
  263. vpHRes                     ds.l    1                ; offset: $16 (22)        ; Horizontal resolution of the device (pixels per inch).
  264. vpVRes                     ds.l    1                ; offset: $1A (26)        ; Vertical resolution of the device (pixels per inch).
  265. vpPixelType                 ds.w    1                ; offset: $1E (30)        ; Defines the pixel type.
  266. vpPixelSize                 ds.w    1                ; offset: $20 (32)        ; Number of bits in pixel.
  267. vpCmpCount                 ds.w    1                ; offset: $22 (34)        ; Number of components in pixel.
  268. vpCmpSize                 ds.w    1                ; offset: $24 (36)        ; Number of bits per component
  269. vpPlaneBytes             ds.l    1                ; offset: $26 (38)        ; Offset from one plane to the next.
  270. sizeof                     EQU *                    ; size:   $2A (42)
  271.                         ENDR
  272. ; typedef struct VPBlock *                VPBlockPtr
  273.  
  274. VDEntryRecord            RECORD 0
  275. csTable                     ds.l    1                ; offset: $0 (0)        ; (long) pointer to color table entry=value, r,g,b:INTEGER
  276. sizeof                     EQU *                    ; size:   $4 (4)
  277.                         ENDR
  278. ; typedef struct VDEntryRecord *        VDEntRecPtr
  279.  
  280. ;  Parm block for SetGray control call 
  281. VDGrayRecord            RECORD 0
  282. csMode                     ds.b    1                ; offset: $0 (0)        ; Same as GDDevType value (0=color, 1=mono)
  283. filler                     ds.b    1                ; offset: $1 (1)
  284. sizeof                     EQU *                    ; size:   $2 (2)
  285.                         ENDR
  286. ; typedef struct VDGrayRecord *            VDGrayPtr
  287.  
  288. ;  Parm block for SetInterrupt call 
  289. VDFlagRecord            RECORD 0
  290. csMode                     ds.b    1                ; offset: $0 (0)
  291. filler                     ds.b    1                ; offset: $1 (1)
  292. sizeof                     EQU *                    ; size:   $2 (2)
  293.                         ENDR
  294. ; typedef struct VDFlagRecord *            VDFlagRecPtr
  295.  
  296. ;  Parm block for SetEntries control call 
  297. VDSetEntryRecord        RECORD 0
  298. csTable                     ds.l    1                ; offset: $0 (0)        ; Pointer to an array of color specs
  299. csStart                     ds.w    1                ; offset: $4 (4)        ; Which spec in array to start with, or -1
  300. csCount                     ds.w    1                ; offset: $6 (6)        ; Number of color spec entries to set
  301. sizeof                     EQU *                    ; size:   $8 (8)
  302.                         ENDR
  303. ; typedef struct VDSetEntryRecord *        VDSetEntryPtr
  304.  
  305. ;  Parm block for SetGamma control call 
  306. VDGammaRecord            RECORD 0
  307. csGTable                 ds.l    1                ; offset: $0 (0)        ; pointer to gamma table
  308. sizeof                     EQU *                    ; size:   $4 (4)
  309.                         ENDR
  310. ; typedef struct VDGammaRecord *        VDGamRecPtr
  311.  
  312. VDBaseAddressInfoRec    RECORD 0
  313. csDevData                 ds.l    1                ; offset: $0 (0)        ;  LONGINT - (long) timing mode 
  314. csDevBase                 ds.l    1                ; offset: $4 (4)        ;  LONGINT - (long) base address of the mode 
  315. csModeReserved             ds.w    1                ; offset: $8 (8)        ;  INTEGER - (short) will some day be the depth 
  316. csModeBase                 ds.l    1                ; offset: $A (10)        ;  LONGINT - (long) reserved 
  317. sizeof                     EQU *                    ; size:   $E (14)
  318.                         ENDR
  319. ; typedef struct VDBaseAddressInfoRec *    VDBaseAddressInfoPtr
  320.  
  321. VDSwitchInfoRec            RECORD 0
  322. csMode                     ds.w    1                ; offset: $0 (0)        ; (word) mode depth
  323. csData                     ds.l    1                ; offset: $2 (2)        ; (long) functional sResource of mode
  324. csPage                     ds.w    1                ; offset: $6 (6)        ; (word) page to switch in
  325. csBaseAddr                 ds.l    1                ; offset: $8 (8)        ; (long) base address of page (return value)
  326. csReserved                 ds.l    1                ; offset: $C (12)        ; (long) Reserved (set to 0) 
  327. sizeof                     EQU *                    ; size:   $10 (16)
  328.                         ENDR
  329. ; typedef struct VDSwitchInfoRec *        VDSwitchInfoPtr
  330.  
  331. VDTimingInfoRec            RECORD 0
  332. csTimingMode             ds.l    1                ; offset: $0 (0)        ;  LONGINT - (long) timing mode (a la InitGDevice) 
  333. csTimingReserved         ds.l    1                ; offset: $4 (4)        ;  LONGINT - (long) reserved 
  334. csTimingFormat             ds.l    1                ; offset: $8 (8)        ;  LONGINT - (long) what format is the timing info 
  335. csTimingData             ds.l    1                ; offset: $C (12)        ;  LONGINT - (long) data supplied by driver 
  336. csTimingFlags             ds.l    1                ; offset: $10 (16)        ;  LONGINT - (long) mode within device 
  337. sizeof                     EQU *                    ; size:   $14 (20)
  338.                         ENDR
  339. ; typedef struct VDTimingInfoRec *        VDTimingInfoPtr
  340.  
  341. VDDisplayConnectInfoRec    RECORD 0
  342. csDisplayType             ds.w    1                ; offset: $0 (0)        ;  INTEGER - (word) Type of display connected 
  343. csConnectTaggedType         ds.b    1                ; offset: $2 (2)        ;  BYTE - type of tagging 
  344. csConnectTaggedData         ds.b    1                ; offset: $3 (3)        ;  BYTE - tagging data 
  345. csConnectFlags             ds.l    1                ; offset: $4 (4)        ;  LONGINT - (long) tell us about the connection 
  346. csDisplayComponent         ds.l    1                ; offset: $8 (8)        ;  LONGINT - (long) if the card has a direct connection to the display, it returns the display component here (FUTURE) 
  347. csConnectReserved         ds.l    1                ; offset: $C (12)        ;  LONGINT - (long) reserved 
  348. sizeof                     EQU *                    ; size:   $10 (16)
  349.                         ENDR
  350. ; typedef struct VDDisplayConnectInfoRec * VDDisplayConnectInfoPtr
  351.  
  352. ;
  353. ; RawSenseCode
  354. ;    This abstract data type is not exactly abstract.  Rather, it is merely enumerated constants
  355. ;    for the possible raw sense code values when 'standard' sense code hardware is implemented.
  356. ;
  357. ;    For 'standard' sense code hardware, the raw sense is obtained as follows:
  358. ;        * Instruct the frame buffer controller NOT to actively drive any of the monitor sense lines
  359. ;        * Read the state of the monitor sense lines 2, 1, and 0.  (2 is the MSB, 0 the LSB)
  360. ;
  361. ;    IMPORTANT Note: 
  362. ;    When the 'kTaggingInfoNonStandard' bit of 'csConnectFlags' is FALSE, then these constants 
  363. ;    are valid 'csConnectTaggedType' values in 'VDDisplayConnectInfo' 
  364. ;
  365. ;
  366. ; typedef unsigned char                 RawSenseCode
  367.  
  368.  
  369. kRSCZero                        EQU        0
  370. kRSCOne                            EQU        1
  371. kRSCTwo                            EQU        2
  372. kRSCThree                        EQU        3
  373. kRSCFour                        EQU        4
  374. kRSCFive                        EQU        5
  375. kRSCSix                            EQU        6
  376. kRSCSeven                        EQU        7
  377. ;
  378. ; ExtendedSenseCode
  379. ;    This abstract data type is not exactly abstract.  Rather, it is merely enumerated constants
  380. ;    for the values which are possible when the extended sense algorithm is applied to hardware
  381. ;    which implements 'standard' sense code hardware.
  382. ;
  383. ;     For 'standard' sense code hardware, the extended sense code algorithm is as follows:
  384. ;    (Note:  as described here, sense line 'A' corresponds to '2', 'B' to '1', and 'C' to '0')
  385. ;        * Drive sense line 'A' low and read the values of 'B' and 'C'.  
  386. ;        * Drive sense line 'B' low and read the values of 'A' and 'C'.
  387. ;        * Drive sense line 'C' low and read the values of 'A' and 'B'.
  388. ;
  389. ;    In this way, a six-bit number of the form BC/AC/AB is generated. 
  390. ;
  391. ;    IMPORTANT Note: 
  392. ;    When the 'kTaggingInfoNonStandard' bit of 'csConnectFlags' is FALSE, then these constants 
  393. ;    are valid 'csConnectTaggedData' values in 'VDDisplayConnectInfo' 
  394. ;
  395. ;
  396. ; typedef unsigned char                 ExtendedSenseCode
  397.  
  398.  
  399. kESCZero21Inch                    EQU        $00                    ; 21" RGB                                 
  400. kESCOnePortraitMono                EQU        $14                    ; Portrait Monochrome                     
  401. kESCTwo12Inch                    EQU        $21                    ; 12" RGB                                
  402. kESCThree21InchRadius            EQU        $31                    ; 21" RGB (Radius)                        
  403. kESCThree21InchMonoRadius        EQU        $34                    ; 21" Monochrome (Radius)                 
  404. kESCThree21InchMono                EQU        $35                    ; 21" Monochrome                        
  405. kESCFourNTSC                    EQU        $0A                    ; NTSC                                 
  406. kESCFivePortrait                EQU        $1E                    ; Portrait RGB                         
  407. kESCSixMSB1                        EQU        $03                    ; MultiScan Band-1 (12" thru 1Six")    
  408. kESCSixMSB2                        EQU        $0B                    ; MultiScan Band-2 (13" thru 19")        
  409. kESCSixMSB3                        EQU        $23                    ; MultiScan Band-3 (13" thru 21")        
  410. kESCSixStandard                    EQU        $2B                    ; 13"/14" RGB or 12" Monochrome        
  411. kESCSevenPAL                    EQU        $00                    ; PAL                                    
  412. kESCSevenNTSC                    EQU        $14                    ; NTSC                                 
  413. kESCSevenVGA                    EQU        $17                    ; VGA                                     
  414. kESCSeven16Inch                    EQU        $2D                    ; 16" RGB (GoldFish)                      
  415. kESCSevenPALAlternate            EQU        $30                    ; PAL (Alternate)                         
  416. kESCSeven19Inch                    EQU        $3A                    ; Third-Party 19''                        
  417. kESCSevenNoDisplay                EQU        $3F                    ; No display connected                 
  418. ;
  419. ; DepthMode
  420. ;    This abstract data type is used to to reference RELATIVE pixel depths.
  421. ;    Its definition is largely derived from its past usage, analogous to 'xxxVidMode'
  422. ;
  423. ;    Bits per pixel DOES NOT directly map to 'DepthMode'  For example, on some
  424. ;    graphics hardware, 'kDepthMode1' may represent 1 BPP, whereas on other
  425. ;    hardware, 'kDepthMode1' may represent 8BPP.
  426. ;
  427. ;    DepthMode IS considered to be ordinal, i.e., operations such as <, >, ==, etc.
  428. ;    behave as expected.  The values of the constants which comprise the set are such
  429. ;    that 'kDepthMode4 < kDepthMode6' behaves as expected.
  430. ;
  431. ; typedef unsigned short                 DepthMode
  432.  
  433.  
  434. kDepthMode1                        EQU        128
  435. kDepthMode2                        EQU        129
  436. kDepthMode3                        EQU        130
  437. kDepthMode4                        EQU        131
  438. kDepthMode5                        EQU        132
  439. kDepthMode6                        EQU        133
  440.  
  441. kFirstDepthMode                    EQU        128                    ; These constants are obsolete, and just included    
  442. kSecondDepthMode                EQU        129                    ; for clients that have converted to the above        
  443. kThirdDepthMode                    EQU        130                    ; kDepthModeXXX constants.                            
  444. kFourthDepthMode                EQU        131
  445. kFifthDepthMode                    EQU        132
  446. kSixthDepthMode                    EQU        133
  447. VDPageInfo                RECORD 0
  448. csMode                     ds.w    1                ; offset: $0 (0)        ; (word) mode within device
  449. csData                     ds.l    1                ; offset: $2 (2)        ; (long) data supplied by driver
  450. csPage                     ds.w    1                ; offset: $6 (6)        ; (word) page to switch in
  451. csBaseAddr                 ds.l    1                ; offset: $8 (8)        ; (long) base address of page
  452. sizeof                     EQU *                    ; size:   $C (12)
  453.                         ENDR
  454. ; typedef struct VDPageInfo *            VDPgInfoPtr
  455.  
  456. VDSizeInfo                RECORD 0
  457. csHSize                     ds.w    1                ; offset: $0 (0)        ; (word) desired/returned h size
  458. csHPos                     ds.w    1                ; offset: $2 (2)        ; (word) desired/returned h position
  459. csVSize                     ds.w    1                ; offset: $4 (4)        ; (word) desired/returned v size
  460. csVPos                     ds.w    1                ; offset: $6 (6)        ; (word) desired/returned v position
  461. sizeof                     EQU *                    ; size:   $8 (8)
  462.                         ENDR
  463. ; typedef struct VDSizeInfo *            VDSzInfoPtr
  464.  
  465. VDSettings                RECORD 0
  466. csParamCnt                 ds.w    1                ; offset: $0 (0)        ; (word) number of params
  467. csBrightMax                 ds.w    1                ; offset: $2 (2)        ; (word) max brightness
  468. csBrightDef                 ds.w    1                ; offset: $4 (4)        ; (word) default brightness
  469. csBrightVal                 ds.w    1                ; offset: $6 (6)        ; (word) current brightness
  470. csCntrstMax                 ds.w    1                ; offset: $8 (8)        ; (word) max contrast
  471. csCntrstDef                 ds.w    1                ; offset: $A (10)        ; (word) default contrast
  472. csCntrstVal                 ds.w    1                ; offset: $C (12)        ; (word) current contrast
  473. csTintMax                 ds.w    1                ; offset: $E (14)        ; (word) max tint
  474. csTintDef                 ds.w    1                ; offset: $10 (16)        ; (word) default tint
  475. csTintVal                 ds.w    1                ; offset: $12 (18)        ; (word) current tint
  476. csHueMax                 ds.w    1                ; offset: $14 (20)        ; (word) max hue
  477. csHueDef                 ds.w    1                ; offset: $16 (22)        ; (word) default hue
  478. csHueVal                 ds.w    1                ; offset: $18 (24)        ; (word) current hue
  479. csHorizDef                 ds.w    1                ; offset: $1A (26)        ; (word) default horizontal
  480. csHorizVal                 ds.w    1                ; offset: $1C (28)        ; (word) current horizontal
  481. csHorizMax                 ds.w    1                ; offset: $1E (30)        ; (word) max horizontal
  482. csVertDef                 ds.w    1                ; offset: $20 (32)        ; (word) default vertical
  483. csVertVal                 ds.w    1                ; offset: $22 (34)        ; (word) current vertical
  484. csVertMax                 ds.w    1                ; offset: $24 (36)        ; (word) max vertical
  485. sizeof                     EQU *                    ; size:   $26 (38)
  486.                         ENDR
  487. ; typedef struct VDSettings *            VDSettingsPtr
  488.  
  489. VDDefMode                RECORD 0
  490. csID                     ds.b    1                ; offset: $0 (0)
  491. filler                     ds.b    1                ; offset: $1 (1)
  492. sizeof                     EQU *                    ; size:   $2 (2)
  493.                         ENDR
  494. ; typedef struct VDDefMode *            VDDefModePtr
  495.  
  496. VDSyncInfoRec            RECORD 0
  497. csMode                     ds.b    1                ; offset: $0 (0)
  498. csFlags                     ds.b    1                ; offset: $1 (1)
  499. sizeof                     EQU *                    ; size:   $2 (2)
  500.                         ENDR
  501. ; typedef struct VDSyncInfoRec *        VDSyncInfoPtr
  502.  
  503. ; typedef unsigned long                 DisplayModeID
  504.  
  505. ; typedef unsigned long                 VideoDeviceType
  506.  
  507. ; typedef unsigned long                 GammaTableID
  508.  
  509. ;  Constants for the GetNextResolution call 
  510.  
  511. kDisplayModeIDCurrent            EQU        $00                    ; Reference the Current DisplayModeID 
  512. kDisplayModeIDInvalid            EQU        $FFFFFFFF            ; A bogus DisplayModeID in all cases 
  513. kDisplayModeIDFindFirstResolution EQU    $FFFFFFFE            ; Used in cscGetNextResolution to reset iterator 
  514. kDisplayModeIDNoMoreResolutions    EQU        $FFFFFFFD            ; Used in cscGetNextResolution to indicate End Of List 
  515. ;  Constants for the GetGammaInfoList call 
  516.  
  517. kGammaTableIDFindFirst            EQU        $FFFFFFFE            ; Get the first gamma table ID 
  518. kGammaTableIDNoMoreTables        EQU        $FFFFFFFD            ; Used to indicate end of list 
  519. kGammaTableIDSpecific            EQU        $00                    ; Return the info for the given table id 
  520. VDResolutionInfoRec        RECORD 0
  521. csPreviousDisplayModeID     ds.l    1                ; offset: $0 (0)        ;  ID of the previous resolution in a chain 
  522. csDisplayModeID             ds.l    1                ; offset: $4 (4)        ;  ID of the next resolution 
  523. csHorizontalPixels         ds.l    1                ; offset: $8 (8)        ;  # of pixels in a horizontal line at the max depth 
  524. csVerticalLines             ds.l    1                ; offset: $C (12)        ;  # of lines in a screen at the max depth 
  525. csRefreshRate             ds.l    1                ; offset: $10 (16)        ;  Vertical Refresh Rate in Hz 
  526. csMaxDepthMode             ds.w    1                ; offset: $14 (20)        ;  0x80-based number representing max bit depth 
  527. csResolutionFlags         ds.l    1                ; offset: $16 (22)        ;  Reserved - flag bits 
  528. csReserved                 ds.l    1                ; offset: $1A (26)        ;  Reserved 
  529. sizeof                     EQU *                    ; size:   $1E (30)
  530.                         ENDR
  531. ; typedef struct VDResolutionInfoRec *    VDResolutionInfoPtr
  532.  
  533. VDVideoParametersInfoRec RECORD 0
  534. csDisplayModeID             ds.l    1                ; offset: $0 (0)        ;  the ID of the resolution we want info on 
  535. csDepthMode                 ds.w    1                ; offset: $4 (4)        ;  The bit depth we want the info on (0x80 based) 
  536. csVPBlockPtr             ds.l    1                ; offset: $6 (6)        ;  Pointer to a video parameter block 
  537. csPageCount                 ds.l    1                ; offset: $A (10)        ;  Number of pages supported by the resolution 
  538. csDeviceType             ds.l    1                ; offset: $E (14)        ;  Device Type:  Direct, Fixed or CLUT; 
  539. csReserved                 ds.l    1                ; offset: $12 (18)        ;  Reserved 
  540. sizeof                     EQU *                    ; size:   $16 (22)
  541.                         ENDR
  542. ; typedef struct VDVideoParametersInfoRec * VDVideoParametersInfoPtr
  543.  
  544. VDGammaInfoRec            RECORD 0
  545. csLastGammaID             ds.l    1                ; offset: $0 (0)        ;  the ID of the previous gamma table 
  546. csNextGammaID             ds.l    1                ; offset: $4 (4)        ;  the ID of the next gamma table 
  547. csGammaPtr                 ds.l    1                ; offset: $8 (8)        ;  Ptr to a gamma table data 
  548. csReserved                 ds.l    1                ; offset: $C (12)        ;  Reserved 
  549. sizeof                     EQU *                    ; size:   $10 (16)
  550.                         ENDR
  551. ; typedef struct VDGammaInfoRec *        VDGammaInfoPtr
  552.  
  553. VDGetGammaListRec        RECORD 0
  554. csPreviousGammaTableID     ds.l    1                ; offset: $0 (0)        ;  ID of the previous gamma table 
  555. csGammaTableID             ds.l    1                ; offset: $4 (4)        ;  ID of the gamma table following csPreviousDisplayModeID 
  556. csGammaTableSize         ds.l    1                ; offset: $8 (8)        ;  Size of the gamma table in bytes 
  557. csGammaTableName         ds.l    1                ; offset: $C (12)        ;  Gamma table name (c-string) 
  558. sizeof                     EQU *                    ; size:   $10 (16)
  559.                         ENDR
  560. ; typedef struct VDGetGammaListRec *    VDGetGammaListPtr
  561.  
  562. VDRetrieveGammaRec        RECORD 0
  563. csGammaTableID             ds.l    1                ; offset: $0 (0)        ;  ID of gamma table to retrieve 
  564. csGammaTablePtr             ds.l    1                ; offset: $4 (4)        ;  Location to copy desired gamma to 
  565. sizeof                     EQU *                    ; size:   $8 (8)
  566.                         ENDR
  567. ; typedef struct VDRetrieveGammaRec *    VDRetrieveGammaPtr
  568.  
  569. VDSetHardwareCursorRec    RECORD 0
  570. csCursorRef                 ds.l    1                ; offset: $0 (0)        ;  reference to cursor data 
  571. csReserved1                 ds.l    1                ; offset: $4 (4)        ;  reserved for future use 
  572. csReserved2                 ds.l    1                ; offset: $8 (8)        ;  should be ignored 
  573. sizeof                     EQU *                    ; size:   $C (12)
  574.                         ENDR
  575. ; typedef struct VDSetHardwareCursorRec * VDSetHardwareCursorPtr
  576.  
  577. VDDrawHardwareCursorRec    RECORD 0
  578. csCursorX                 ds.l    1                ; offset: $0 (0)        ;  x coordinate 
  579. csCursorY                 ds.l    1                ; offset: $4 (4)        ;  y coordinate 
  580. csCursorVisible             ds.l    1                ; offset: $8 (8)        ;  true if cursor is must be visible 
  581. csReserved1                 ds.l    1                ; offset: $C (12)        ;  reserved for future use 
  582. csReserved2                 ds.l    1                ; offset: $10 (16)        ;  should be ignored 
  583. sizeof                     EQU *                    ; size:   $14 (20)
  584.                         ENDR
  585. ; typedef struct VDDrawHardwareCursorRec * VDDrawHardwareCursorPtr
  586.  
  587. VDSupportsHardwareCursorRec RECORD 0
  588. csSupportsHardwareCursor  ds.l    1                ; offset: $0 (0)
  589. ;  true if hardware cursor is supported 
  590. csReserved1                 ds.l    1                ; offset: $4 (4)        ;  reserved for future use 
  591. csReserved2                 ds.l    1                ; offset: $8 (8)        ;  must be zero 
  592. sizeof                     EQU *                    ; size:   $C (12)
  593.                         ENDR
  594. ; typedef struct VDSupportsHardwareCursorRec * VDSupportsHardwareCursorPtr
  595.  
  596. VDHardwareCursorDrawStateRec RECORD 0
  597. csCursorX                 ds.l    1                ; offset: $0 (0)        ;  x coordinate 
  598. csCursorY                 ds.l    1                ; offset: $4 (4)        ;  y coordinate 
  599. csCursorVisible             ds.l    1                ; offset: $8 (8)        ;  true if cursor is visible 
  600. csCursorSet                 ds.l    1                ; offset: $C (12)        ;  true if cursor successfully set by last set control call 
  601. csReserved1                 ds.l    1                ; offset: $10 (16)        ;  reserved for future use 
  602. csReserved2                 ds.l    1                ; offset: $14 (20)        ;  must be zero 
  603. sizeof                     EQU *                    ; size:   $18 (24)
  604.                         ENDR
  605. ; typedef struct VDHardwareCursorDrawStateRec * VDHardwareCursorDrawStatePtr
  606.  
  607. VDConvolutionInfoRec    RECORD 0
  608. csDisplayModeID             ds.l    1                ; offset: $0 (0)        ;  the ID of the resolution we want info on 
  609. csDepthMode                 ds.w    1                ; offset: $4 (4)        ;  The bit depth we want the info on (0x80 based) 
  610. csPage                     ds.l    1                ; offset: $6 (6)
  611. csFlags                     ds.l    1                ; offset: $A (10)
  612. csReserved                 ds.l    1                ; offset: $E (14)
  613. sizeof                     EQU *                    ; size:   $12 (18)
  614.                         ENDR
  615. ; typedef struct VDConvolutionInfoRec *    VDConvolutionInfoPtr
  616.  
  617. VDPowerStateRec            RECORD 0
  618. powerState                 ds.l    1                ; offset: $0 (0)
  619. powerFlags                 ds.l    1                ; offset: $4 (4)
  620. powerReserved1             ds.l    1                ; offset: $8 (8)
  621. powerReserved2             ds.l    1                ; offset: $C (12)
  622. sizeof                     EQU *                    ; size:   $10 (16)
  623.                         ENDR
  624. ; typedef struct VDPowerStateRec *        VDPowerStatePtr
  625.  
  626. ;
  627. ;    Private Data to video drivers.
  628. ;    
  629. ;    In versions of MacOS with multiple address spaces (System 8), the OS 
  630. ;    must know the extent of parameters in order to move them between the caller
  631. ;    and driver.  The old private-selector model for video drivers does not have
  632. ;    this information so:
  633. ;    
  634. ;    For post-7.x Systems private calls should be implemented using the cscPrivateCall
  635. ;
  636. VDPrivateSelectorDataRec RECORD 0
  637. privateParameters         ds.l    1                ; offset: $0 (0)        ;  Caller's parameters
  638. privateParametersSize     ds.l    1                ; offset: $4 (4)        ;  Size of data sent from caller to driver
  639. privateResults             ds.l    1                ; offset: $8 (8)        ;  Caller's return area. Can be nil, or same as privateParameters.
  640. privateResultsSize         ds.l    1                ; offset: $C (12)        ;  Size of data driver returns to caller. Can be nil, or same as privateParametersSize.
  641. sizeof                     EQU *                    ; size:   $10 (16)
  642.                         ENDR
  643. VDPrivateSelectorRec    RECORD 0
  644. reserved                 ds.l    1                ; offset: $0 (0)        ;  Reserved (set to 0). 
  645. data                     ds        VDPrivateSelectorDataRec ; offset: $4 (4) <-- really an array of length one
  646. sizeof                     EQU *                    ; size:   $14 (20)
  647.                         ENDR
  648.     ENDIF ; __VIDEO__ 
  649.  
  650.